<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>运行时配置</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mysqli.installation.html">安装</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mysqli.resources.html">资源类型</a></div>
 <div class="up"><a href="mysqli.setup.html">安装／配置</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="mysqli.configuration" class="section">
 <h2 class="title">运行时配置</h2>
 <p class="simpara">
这些函数的行为受 <var class="filename">php.ini</var> 中的设置影响。
</p>
 <p class="para">
  <table class="doctable table">
   <caption><strong>MySQLi配置选项</strong></caption>
   
    <thead>
     <tr>
      <th>名字</th>
      <th>默认</th>
      <th>可修改范围</th>
      <th>更新日志</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.allow-local-infile" class="link">mysqli.allow_local_infile</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 5.2.4起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.allow-persistent" class="link">mysqli.allow_persistent</a></td>
      <td>&quot;1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 5.3.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.max-persistent" class="link">mysqli.max_persistent</a></td>
      <td>&quot;-1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 5.3.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.max-links" class="link">mysqli.max_links</a></td>
      <td>&quot;-1&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.default-port" class="link">mysqli.default_port</a></td>
      <td>&quot;3306&quot;</td>
      <td>PHP_INI_ALL</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.default-socket" class="link">mysqli.default_socket</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.default-host" class="link">mysqli.default_host</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.default-user" class="link">mysqli.default_user</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.default-pw" class="link">mysqli.default_pw</a></td>
      <td>NULL</td>
      <td>PHP_INI_ALL</td>
      <td>自PHP 5.0.0起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.reconnect" class="link">mysqli.reconnect</a></td>
      <td>&quot;0&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 4.3.5起可用。</td>
     </tr>

     <tr>
      <td><a href="mysqli.configuration.html#ini.mysqli.cache-size" class="link">mysqli.cache_size</a></td>
      <td>&quot;2000&quot;</td>
      <td>PHP_INI_SYSTEM</td>
      <td>自PHP 5.3.0起可用。</td>
     </tr>

    </tbody>
   
  </table>

 </p>
 <p class="para">
 关于前面出现的PHP_INI_*系列常量的详细定义，请参阅<a href="configuration.changes.html" class="link">配置的修改</a>一章。
 </p>

 <p class="para">这是配置指令的简短说明。</p>

 <p class="para">
 <dl>

  
  
  
   <dt id="ini.mysqli.allow-local-infile">
    <em><code class="parameter">mysqli.allow_local_infile</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
     允许Mysql的Load Data语句访问PHP角度看的本地文件。
    </p>
   </dd>

  
  
  
  
   <dt id="ini.mysqli.allow-persistent">
    <em><code class="parameter">mysqli.allow_persistent</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
    开启使用<span class="function"><a href="function.mysqli-connect.html" class="function">mysqli_connect()</a></span>函数创建持久化连接的能力。
    </p>
   </dd>

  
  
   <dt id="ini.mysqli.max-persistent">
    <em><code class="parameter">mysqli.max_persistent</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
    可以创建的持久化连接的最大数量，设置为0表明不限制。
    </p>
   </dd>

  
  
   <dt id="ini.mysqli.max-links">
    <em><code class="parameter">mysqli.max_links</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
    每个进程中Mysql连接的最大数量。
    </p>
   </dd>

  
   
   <dt id="ini.mysqli.default-port">
    <em><code class="parameter">mysqli.default_port</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
    当没有指定其他端口号时使用的默认的用于连接数据库服务器的TCP端口号。如果没有设置默认值，
    端口号将会按照顺序从环境变量<em>MYSQL_TCP_PORT</em>，<var class="filename">/etc/services</var>
    文件中的<em>mysql-tcp</em>条目或编译期的<em>MYSQL_PORT</em>常量等位置获取。
    Win32仅使用<em>MYSQL_PORT</em>常量。
    </p>
   </dd>

  
  
  
   <dt id="ini.mysqli.default-socket">
    <em><code class="parameter">mysqli.default_socket</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <p class="para">
    当连接到本地数据库服务器时如果没有指定其他socket名称，使用的默认socket名称。
    </p>
   </dd>

  
  
  

  
   
   <dt id="ini.mysqli.default-host">
    <em><code class="parameter">mysqli.default_host</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <p class="para">
    当连接到数据库服务器时， 如果没有指定其他主机地址，使用的默认服务器主机。不要在
    <a href="ini.sect.safe-mode.html#ini.safe-mode" class="link">安全模式</a>下使用。
    </p>
   </dd>

  

  

  
  
   <dt id="ini.mysqli.default-user">
    <em><code class="parameter">mysqli.default_user</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <p class="para">
    当连接到数据库服务器时，如果没有指定其他用户名，使用的默认用户名。不要在
    <a href="ini.sect.safe-mode.html#ini.safe-mode" class="link">安全模式</a>下使用。
    </p>
   </dd>

  
  
    
   <dt id="ini.mysqli.default-pw">
    <em><code class="parameter">mysqli.default_pw</code></em>
    <span class="type"><a href="language.types.string.html" class="type string">string</a></span>
   </dt>

   <dd>

    <p class="para">
    当连接到数据库服务器时，如果灭有指定其他密码，使用的默认密码。不要在
    <a href="ini.sect.safe-mode.html#ini.safe-mode" class="link">安全模式</a>下使用。
    </p>
   </dd>

  
  
  
    
   <dt id="ini.mysqli.reconnect">
    <em><code class="parameter">mysqli.reconnect</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
    连接丢失时是否自动重新连接。
    </p>
   </dd>

  
  
   <dt id="ini.mysqli.cache-size">
    <em><code class="parameter">mysqli.cache_size</code></em>
    <span class="type"><a href="language.types.integer.html" class="type integer">integer</a></span>
   </dt>

   <dd>

    <p class="para">
     仅可用于 <a href="book.mysqlnd.html" class="link">mysqlnd</a>。
    </p>
   </dd>

  
  
 </dl>

 </p>
 <p class="para">
 用户不能通过API调用或运行时配置来设置<em>MYSQL_OPT_READ_TIMEOUT</em>。
 注意，如果可能这样做那么<em>libmysql</em>和流对<em>MYSQL_OPT_READ_TIMEOUT</em>
 的值将会有不同的解释。 
 </p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="mysqli.installation.html">安装</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="mysqli.resources.html">资源类型</a></div>
 <div class="up"><a href="mysqli.setup.html">安装／配置</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
